Installation

Installing the iRPGUnit plug-in requires three steps:

Optional:

Installing the iRPGUnit Plug-in

What Should I Install?

Everything of category iRPGUnit for IBM i belongs to the base components of iRPGUnit and must or at least should be installed:

Features of category iRPGUnit for IBM i (optional features) are optional and can be installed depending on your needs:

Features of category iRPGUnit for IBM i (optional integration features) are optional and can be installed depending on your needs:

Using Eclipse Marketplace

From the main menu, select "Help > Eclipse Marketplace..." to enter the marketplace. Search for 'iRPGUnit' and click the [Install] button:

Then select the options you want to install, press the [Confirm] button and follow the instructions given on the following pages.

Using the update site

The URL of the iRPGUnit plug-in update site is:

https://tools-400.github.io/irpgunit/update-site/eclipse/rdi8.0/

Open the Update site with your preferred Internet browser.

From the main menu, select "Help > Install New Software..." to enter the "Install" dialog.

Then Drag-and-Drop the URL of the update site from your browser into the "Work with:" field:

RDi: Install new software

Then select the options you want to install, press the [Next] button and follow the instructions given on the following pages.

Using a Local Update Directory

Go to the iRPGUnit 'GitHub Files' page.

Then follow these steps to create your local update site:

Select the options you want to install, press the [Next] button and follow the instructions given on the following pages.

Using a Local Update Archive

Go to the iRPGUnit 'GitHub Files' page.

Then follow these steps to create your local update site:

Select the options you want to install, press the [Next] button and follow the instructions given on the following pages.

Installing the RPGUnit Library

There are several options to install the library. Your favourite should be the the integrated Installation Wizard.

Using the Embedded Installation Wizard

The most easiest way to install the library is to upload it from the preference page of the iRPGUnit plug-in. However that requires that you are allowed to start a FTP connection to your host.

Take these steps to transfer the library:

You do not necessarily need to compile the library unless you want to run the RPGUnit self-test or in case you did not use the default library name RPGUNIT.

Transfer Save File With 'upload_savf.cmd'

Download the zipped update site from the iRPGUnit 'GitHub Files' page, e.g. iRPGUnit for RDi 9.5.1.3+ (v4.0.0.r Update Site).zip.

Unzip upload_savf.cmd from sub-folder Server to an empty folder on your PC.

Unzip RPGUNIT.SAVF from sub-folder Server to the same folder on your PC.

Run upload_savf.cmd with the following parameters:

  upload_savf.cmd hostName userName password
Calling upload_savf.cmd without parameters displays usage instructions.

Go ahead with Compiling the RPGUnit Library.

Transfer Save File by Hand

Please create an empty save file on your server before uploading the file:

Create save file:
  CRTSAVF FILE(QGPL/RPGUNIT)
Now use FTP to transfer the save file to your server:
Open a DOS box:
  XP, Win7: Start -> Execute -> cmd.exe

Start an FTP session to your server:
  FTP your.server.com

Transfer save file:
  binary
  put RPGUnit_v* QGPL/RPGUNIT
  
Terminate FTP session:
  quit

Go ahead with Compiling the RPGUnit Library.

Compiling the RPGUnit Library

Logon to your server, restore library RPGUNIT from the save file and add the library to your library list:

  RSTLIB SAVLIB(RPGUNIT) DEV(*SAVF) SAVF(QGPL/RPGUNIT)
  ADDLIBLE LIB(RPGUNIT)
Execute the Rexx install script A_INSTALL to create the RPGUnit objects:
  STRREXPRC SRCMBR(A_INSTALL) SRCFILE(QBUILD) PARM('install')

Use the following command if you used a different library name, e.g. RPGUNIT3:

  STRREXPRC SRCMBR(A_INSTALL) SRCFILE(QBUILD) PARM('install RPGUNIT3')

By default the iRPGUnit objects are compiled without debug data. Add parameter list if you want to compile the objects with debug data:

  STRREXPRC SRCMBR(A_INSTALL) SRCFILE(QBUILD) PARM('install RPGUNIT list')

Finished.

Do not forget to add library RPGUNIT to the library list of your Remote Connection or change the product library from *LIBL to the actual library on the iRPGUnit preference page.

Renaming the RPGUnit Library

Starting with version 4 you can use the UPDLIB command to update the references between the RPGUnit objects after renaming the library.

  UPDLIB LIB(libName)

Then the library does not necessarily have to be recompiled.